nfc_ep_data.h

Go to the documentation of this file.

#ifndef NFC_EP_DATA_H
#define NFC_EP_DATA_H
 
/* *************************** NFC Entry Point data definitions **************************** */
/* ***************************************************************************************** */
 
/* set struct alignment */
#include <emv_platform_set_align.h>
 
/* ***************************************************************************************** */
/* ***************************************************************************************** */
 
/* ************************************* Checksum Types ************************************ */
#define NFC_CHECKSUM_BINARY                                                                         0x00        
#define NFC_CHECKSUM_CONFIG                                                                         0x01        
#define NFC_CHECKSUM_FULL_CONFIG                                                                0x02        
/* ***************************************************************************************** */
#define NFC_EP_MASK_STATUS_CHECK                                                                0x0001      
#define NFC_EP_MASK_ZERO_AMOUNT                                                                 0x0002      
#define NFC_EP_MASK_ZERO_AMOUNT_OFFLINE                                                 0x0004      
#define NFC_EP_MASK_RDR_CLESS_LIMIT                                                         0x0008      
#define NFC_EP_MASK_RDR_CLESS_FLOOR_LIMIT                                               0x0010      
#define NFC_EP_MASK_RDR_CVM_REQ_LIMIT                                                       0x0020      
#define NFC_EP_MASK_TTQ                                                                                 0x0040      
#define NFC_EP_MASK_EXT_SEL_SUPPORT                                                         0x0080      
#define NFC_EP_PRE_STATUS_CHECK_REQUESTED                                               0x0001  
#define NFC_EP_PRE_CLESS_APP_NOT_ALLOWED                                                0x0002  
#define NFC_EP_PRE_ZERO_AMOUNT                                                                  0x0004  
#define NFC_EP_PRE_RDR_CVM_REQ_LIMIT_EXCEEDED                                       0x0008  
#define NFC_EP_PRE_RDR_CLESS_FLOOR_LIMIT_EXCEEDED                               0x0010  
/* ***************************************************************************************** */
/* EP preprocessing data struct version ID */
#define NFC_EP_PRE_VERSION                                                                          0x01    
/* ***************************************************************************************** */
 
/* ***************************************************************************************** */
/* reset EP preprocessing data macro */
#define NFC_EP_PRE_RESET(DATA, SIZE)    \
do  \
{   \
    KER_MEM_SET(DATA, SIZE, 0, SIZE);   \
    (DATA)->usSize = SIZE;  \
    (DATA)->btVersion = NFC_EP_PRE_VERSION; \
    (DATA)->pConfigData = KER_NULL; \
    (DATA)->pTranData = KER_NULL; \
} while (0)
 
/* ********************* Entry Point preprocessing data definitions ************************ */
typedef struct tag_NFC_EP_PRE_DATA
{
    KER_INT16U usSize;                              
    KER_BYTE btVersion;                             
    KER_BYTE ar_btAID[16];                      
    KER_BYTE btAIDLen;                              
    KER_BYTE ar_btKernelID[8];              
    KER_BYTE btKernelIDLen;                     
    KER_TLV* pConfigData;                           
    KER_TLV* pTranData;                             
    KER_INT16U usPreDataPresentMask;    
    KER_INT16U usPreDataSetMask;            
    KER_BYTE ar_btTTQ[4];                           
    KER_BYTE ar_btLimitClessTran[4];    
    KER_BYTE ar_btLimitClessFloor[4];   
    KER_BYTE ar_btLimitCVMRequired[4];
    KER_INT16U usPreprocIndicators;     
    KER_BYTE ar_btCopyTTQ[4];                   
}NFC_EP_PRE_DATA;
/* ***************************************************************************************** */
/* EP Card PPSE data struct version ID */
#define NFC_EP_PPSE_VERSION                                                                         0x01    
/* ***************************************************************************************** */
 
/* ***************************************************************************************** */
/* reset PPSE data macro */
#define NFC_EP_PPSE_RESET(DATA, SIZE)   \
do  \
{   \
    KER_MEM_SET(DATA, SIZE, 0, SIZE);   \
    (DATA)->usSize = SIZE;  \
    (DATA)->btVersion = NFC_EP_PPSE_VERSION; \
} while (0)
 
/* ***************************************************************************************** */
typedef struct tag_NFC_EP_PPSE_DATA
{
    KER_INT16U usSize;                              
    KER_BYTE btVersion;                             
    KER_BYTE ar_bt4F[16];                           
    KER_BYTE bt4FLen;                                   
    KER_BYTE bt9F29Len;                             
    KER_BYTE bt87;                                      
} NFC_EP_PPSE_DATA;
/* ***************************************************************************************** */
/* transaction EP indicators */
#define NFC_TRAN_EP_IND_EXT_SELECTION                                                       0x0001  
#define NFC_TRAN_EP_IND_EP_RESTART_FLAG                                                 0x0002  
#define NFC_TRAN_EP_IND_CD_CVM_RESTART                                                  0x0004  
/* ***************************************************************************************** */
 
/* ***************************************************************************************** */
/* EP Tran data struct version ID */
#define NFC_EP_TRAN_DATA_VERSION                                                                0x0001  
/* ***************************************************************************************** */
 
/* ***************************************************************************************** */
/* reset Tran data macro */
#define NFC_EP_TRAN_DATA_RESET(DATA, SIZE)  \
do  \
{   \
    KER_MEM_SET(DATA, SIZE, 0, SIZE);   \
    (DATA)->usSize = SIZE;  \
    (DATA)->btVersion = NFC_EP_TRAN_DATA_VERSION; \
    (DATA)->pTermTranData = KER_NULL; \
    (DATA)->pTermTranDataTLV = KER_NULL; \
    (DATA)->pbt84 = KER_NULL; \
    (DATA)->pbtCPLC = KER_NULL; \
    (DATA)->btEpStart = NFC_OUTCOME_START_TYPE_NA;  \
} while (0)
 
/* external tran data struct, defined in nfc_ext_data.h */
typedef struct tag_NFC_EXT_TERM_TRAN_DATA NFC_EXT_TERM_TRAN_DATA;
 
/* ***************************************************************************************** */
typedef struct tag_NFC_EP_TRAN_DATA
{
    KER_INT16U usSize;                              
    KER_BYTE btVersion;                             
    KER_INT16U usEpIndicators;              
    const NFC_EXT_TERM_TRAN_DATA* pTermTranData;    
    const KER_TLV* pTermTranDataTLV;                            
    KER_BYTE ar_btUN[4];                            
    KER_BYTE ar_bt96[8];                            
    KER_BYTE ar_btLangPref[8];              
    KER_BYTE btLangPrefLen;                     
    KER_INT16U usSW1SW2;                            
    KER_BYTE ar_btSelectResp[EMV_RESP_APDU_MAX_SIZE];   
    KER_INT16U usSelectRespLen;             
    const KER_BYTE* pbt84;                      
    KER_INT16U us84Len;                             
    const KER_BYTE* pbtCPLC;                    
    KER_INT16U usCPLCLen;                           
    KER_BYTE btEpStart;                             
} NFC_EP_TRAN_DATA;
/* ***************************************************************************************** */
/* EP Tran restart data struct version ID */
#define NFC_EP_RESTART_DATA_VERSION                                                         0x0001  
 /* ***************************************************************************************** */
 
 /* ***************************************************************************************** */
 /* reset Tran data macro */
#define NFC_EP_RESTART_DATA_RESET(DATA, SIZE)   \
do  \
{   \
    KER_MEM_SET(DATA, SIZE, 0, SIZE);   \
    (DATA)->usSize = SIZE;  \
    (DATA)->btVersion = NFC_EP_RESTART_DATA_VERSION; \
    (DATA)->btEpStart = NFC_OUTCOME_START_TYPE_NA;  \
} while (0)
 
/* ***************************************************************************************** */
typedef struct tag_NFC_EP_RESTART_DATA
{
    KER_INT16U usSize;                              
    KER_BYTE btVersion;                             
    KER_INT16U usSW1SW2;                            
    KER_BYTE ar_btSelectResp[EMV_RESP_APDU_MAX_SIZE];   
    KER_INT16U usSelectRespLen;             
    KER_BYTE btEpStart;                             
} NFC_EP_RESTART_DATA;
/* *************************************** nfcTran ***************************************** */
typedef struct tag_KER_TRAN KER_TRAN;
 
/* restore struct alignment */
#include <emv_platform_restore_align.h>
 
#endif /* NFC_EP_DATA_H */